home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1995 #5 & #6 / Amiga Plus CD - 1995 - No. 5 and 6.iso / pd / grafik / xv / docs / amiga.readme next >
Text File  |  1995-07-23  |  4KB  |  124 lines
  1.  
  2.  Welcome back to the wonders of Xv..!
  3. ======================================
  4.  
  5.  Requirements:
  6. ===============
  7.  
  8. AGA/OS3.0 is recommended but it may actually work with WB2.04/ECS.
  9.  
  10. This program uses MUI! So it is safe to assume that you should have it
  11. installed before you try to run Xv! (2.2 as found on aminet)
  12.  
  13. Lots of ram may come in handy..
  14.  
  15. Set stack to 20000 or more.
  16.  
  17. rgb.txt has been moved from libs: to the env. var 'HOME'. (or X11HOME)
  18.  
  19.  Environment variables:
  20. ========================
  21.  
  22. Currently there aren't any amiga specific flags but rather some
  23. environment variables that are read by the libX11.
  24.  
  25. setenv X11/usepub Workbench
  26.   The image will be showed in a window on a public screen.
  27.  
  28. setenv X11/gfxcard 1
  29.   Will use WritePixelArray instead of Morten Eriksen's c2p routines. Those
  30.   usually doesn't work too well with gfx cards.
  31.  
  32. some other are described in LibX11.readme
  33.  
  34. These are still usable but in addition the AmigaDefaults file may now
  35. include resource entries like 'xv.force8: true' or 'xv.display: Workbench'.
  36. To see what resource entries xv looks for turn on debugging with
  37. 'setenv X11/debug 1', or have a look in the manual..
  38.  
  39.  Responsibility?:
  40. ==================
  41.  
  42. If the program should crash and destroy 10 years of work on your hard-disk
  43. you may ask for a refund of your contribution. Any other responsibility
  44. for any result of running this program is not granted.
  45. (ie. no responsibility whatsoever..)
  46.  
  47. Shouldn't be too much risk of this though..
  48.  
  49.  Documentation:
  50. ================
  51.  
  52. Documentation is currently limited to the xvdocs.ps that is found
  53. in the original archive. (available on a ftp'site near you..). and
  54. it is 7mb! (ok. 600-700k compressed)
  55.  
  56. Send John Bradley $25 and you will get a nice bound copy!
  57.  
  58.  some hints:
  59. =============
  60.  
  61. on the image screen:
  62. right-alt or ctrl and mousebutton-press will zoom the image in or out.
  63. right mousebutton and drag will make a crop rectangle.
  64. buttonpress will show the value of the pixel under the mousepointer
  65. (on the xv control panel or as current edit color in the coloreditor)
  66.  
  67. <shift>+arrows will change the size of crop rectangle.
  68. arrows will move the crop rectangle.
  69. <ctrl>+arrows crops the image by 1 line or row from the edge.
  70. <escape> changes screen back to workbench.
  71.  
  72. use -display <name> (or setenv xv/display <name>) to make Xv open on this
  73. public screen if you also use -usepub (previously -usewb).
  74.  
  75. A lot of environt variables are possible to set that Xv will check on startup.
  76. These can be found in the documentation (the xvdocs.ps file). Send John Bradley
  77. $25 and you will get a nice bound copy! Some of these may actually work!
  78.  
  79. Try 'setenv xv/autoRaw 1' to force Xv to use raw mode when loading images. 
  80. Useful since the smoothing of images may take some time! ('setenv xv/usepub 1'
  81. and 'setenv xv/nochunky 1' will also work) Its also memory demanding!
  82.  
  83.  bits & pieces:
  84. ================
  85.  So where is the middle button? (Button2). I can't find one on my mouse so
  86. I added a toggle button that switches the right mousebutton into middle mouse
  87. button. 'Caps Lock' will switch buttons. If you have 3 buttons it will probably
  88. work nicely without using 'Caps Lock'.
  89.  
  90. gzip'ed files will be gunzip'ed if you have gunzip in your path.
  91.  
  92. Postscript loading needs the postscript datatype and post.library.
  93.  
  94. The 'meta' key is mapped to the 'alt' key on the amiga.
  95.  
  96. To use the padding menu 'bggen' option you need to place the bggen
  97. program somewhere in the path. Also the program needs to be started
  98. from shell or xicon (to make the system() function work).
  99.  
  100. This version is back to a 'slow' mode since the contributions
  101. dissapeared in a puff of smoke after I uploaded a 'good' version to aminet!
  102. If you would like a better version send $10 to:
  103.  
  104. Terje Pedersen
  105. Oterveien 55
  106. 9017 Tromsoe
  107. Norway
  108.  
  109. This $10 doesn't include 'all upgrades for free'!
  110. Higher amounts ($30 (+-)) will give you a resonable amount of versions
  111. in the mail as they are finished. (this can't be done unless I can
  112. reach you by e-mail since I will soon use up that amount in p&p).
  113.  
  114. And read the intro text! (and take your time :-)
  115.  
  116.  Thanks to:
  117. ============
  118.  
  119. Morten Eriksen for his chunky to planar stuff. Great stuff!
  120. Colin Dalton, Per Espen Hagen, Kjell Irgens and Nils Sudman for betatesting.
  121. Stephan Bischoff for some icons.
  122.  
  123. TP
  124.